Skip to main content

Just getting started with the Metadata API? See the following documents for details on using this API:

Announcements

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

The API release history

The following table lists the most recent releases for the Metadata API. For prior releases, refer to the Metadata API Release Notes Archive.

Version Release Date Summary of Release

Version 1.13.0

2026-03-06

A new method was added to the marketplace resource: getMinimumListingPricePolicies.

Version 1.12.1

2026-03-05

Added the reservePriceAllowed field to the response of getCategoryPolicies.

Version 1.12.0

2025-10-30

Added shipping support through the new shipping:marketplace resource, including five methods: getExcludeShippingLocations, getHandlingTimes, getShippingCarriers, getShippingLocations, and getShippingServices.

Version 1.11.1

2025-07-17

The valueCategory boolean was added to the getCategoryPolicies response to indicate if the returned category is a value category.

Version 1.11.0

2025-05-21

The getCurrencies method was added to the marketplace resource; Metadata support for Global Trade Item Numbers (GTINs) was added and compatibility for motors was enhanced through fields added to the get_category_policies and get_motors_listing_policies resources

Version 1.10.0

2025-03-17

Six methods were added to the marketplace resource: getCategoryPolicies, getClassifiedAdPolicies, getListingTypePolicies, getMotorsListingPolicies, getShippingPolicies, and getSiteVisibilityPolicies

Version 1.9.0

2024-12-18

A new resource, compatibility,has been added, with five new methods to support parts compatibility features
Version 1.8.0

2024-07-09

Two methods were added to the shipping:marketplace resource: getProductSafetyLabels and getRegulatoryPolicies
Version 1.7.1

2023-08-29

In getExtendedProducerResponsibilityPolicies the Extended Producer Responsibility fields are now supported on all marketplaces
Version 1.7.0

2023-06-26

Expanded response payload for getItemConditionPolicies to support condition grading related information

Version 1.13.0

The following section details the updates that have been made for this release.

New method added

This release adds a new endpoint to the marketplace resource. The getMinimumListingPricePolicies method returns minimum listing price policies for supported types of listings on a specific marketplace.

Version 1.12.1

In this release, the getCategoryPolicies response includes a new field: reservePriceAllowed. This boolean indicates whether auction listings in a given category may use a reserve price.

Version 1.12.0

This release adds shipping support through the new shipping:marketplace resource, enabling sellers to retrieve site shipping metadata.

New methods

This following new methods were added: 

Version 1.11.1

The following section details the updates that have been made for this release.

Schema changes

In this release, the valueCategory boolean has been added to the categoryPolicies container of the getCategoryPolicies response. If returned as true, this boolean indicates that the leaf category for the specified site is designated by eBay as a value category. Value categories can be used as a secondary category for a listing at no extra charge.

Version 1.11.0

The following section details the updates that have been made for this release.

Schema changes

The getCurrencies method that supports currency metadata was added to the marketplace resource. This method returns the default currency supported by the eBay system for the site specified in the request.

The getCategoryPolicies method now supports Global Trade Item Numbers (GTINs) metadata by adding three fields to the get_category_policies resource:

Note: GTINs are a set of globally recognized identifiers used to uniquely identify products.

  • eanSupport: Indicates whether or not European Article Numbers (EANs) are supported/required when listing products in the category.

  • isbnSupport: Indicates whether or not International Standard Book Numbers (ISBNs) are supported/required when listing products in the specified category.

  • upcSupport: Indicates whether or not the category on the specified eBay site supports the use of Universal Product Codes (UPCs) to help create a listing.

To support these fields, the enumerated type ProductIdentiferEnabledEnum was added. This type contains values to indicate whether or not the feature can be used or not, or is required or not.

The getMotorsListingPolicies method now provides additional compatibility metadata through two fields in the get_motors_listing_policies resource.

  • kTypeSupported: Indicates the category supports the use of a K Type to identify the cars and trucks compatible with a motor vehicle part or accessory. Only the AU, DE, ES, FR, IT, and UK marketplaces support the use of K Types.

  • minItemCompatibility: Indicates the minimum number of required compatible applications for listing items.

Version 1.10.0

The following section details the updates that have been made for this release.

Support for leaf category metadata added

This release adds support for that allows sellers to retrieve leaf category metadata for a site.

New methods

This release adds the following methods to the marketplace resource: 

Version 1.9.0

The following section details the updates that have been made for this release.

Support for compatibility search

This release adds a new resource, compatibility, that allows sellers to retrieve part compatibility details for a specific category, or for a specific product.

New methods

This release adds the following methods to the compatibility resource: 

Version 1.8.0

The following section details the updates that have been made for this release.

Two methods added

This release adds two new endpoints to the marketplace resource. The getProductSafetyLabels method retrieves available product safety label information for a given eBay marketplace. The getRegulatoryPolicies method allows users to retrieve all eBay categories that support/require regulatory policies data for a given eBay marketplace.

Version 1.7.1

The following section details the update that has been made for this release.

In getExtendedProducerResponsibilityPolicies method the Extended Producer Responsibility fields are now supported on all marketplaces. The following content is changed.

Note: Currently, the Extended Producer Responsibility policies are only applicable to a limited number of categories.

Version 1.7.0

The following section details the updates that have been made for this release.

Support for condition grading related information added

Sellers now have the ability to provide condition grading related information for items in applicable categories. The condition descriptors that an eBay category supports can be returned using the getItemConditionPolicies method.

Note: Condition grading is currently only available for the following trading card categories:

  • Non-Sport Trading Card Singles
  • CCG Individual Cards
  • Sports Trading Card Singles

Schema changes

The following container and its child fields are now available in the getItemConditionPolicies response payload:

  • conditionDescriptors- This container holds the information relating to condition descriptors and condition descriptor values for the specified category or categories.